home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sfwsbtrv.zip / SFWSBTRV.DOC < prev    next >
Text File  |  1990-12-01  |  11KB  |  258 lines
  1.  
  2.                        World Series Baseball Trivia.
  3.  
  4.     They said that Cincinnati would be swept in four games by Oakland!
  5.     Well Oakland fans, eat your hearts out!
  6.  
  7.     This program was written because of the success of the Cincinnati Reds
  8.     in the 1990 baseball season.. It is FREEWARE with no limits, it is yours
  9.     to use or do whatever you wish with it. All that I ask is that you enjoy
  10.     the program!
  11.  
  12.  
  13.                                  
  14.                                    SFWSBTRV 
  15.                                   Version 1.0
  16.                                  by  Walt Bush
  17.                                The Rossmoyne Mall
  18.  
  19.    INTRODUCTION
  20.    ------------
  21.      SFWSBTRV is a fast paced trivia game designed to run as a door feature
  22.    within the SPITFIRE Bulletin Board System version 3.X. Which makes this
  23.    file share compatable.  A data file containing 220 trivia questions is
  24.    randomly accessed and displayed tho the screen. With each question that
  25.    is displayed, four multiple choice options are provided from which the
  26.    player may select their answer.  SFWSBTRV allows the player ten seconds
  27.    to read the question and respond with the number corresponding to the
  28.    answer they believe is correct.
  29.     
  30.    SETUP
  31.    ------
  32.       To set up SFWSBTRV to be executed as a door, it is recommended that
  33.    a separate directory be set up for it.  For explanation purposes, let's
  34.    assume the directory DOOR_A is created for use with SFWSBTRV. The following
  35.    files must then be placed in the directory:
  36.    
  37.    SFWSBTRV.EXE   The actual game program.
  38.    
  39.    SFWSBTRV.DAT   The data file containing the trivia questions.
  40.    
  41.    SFWSBTRV.TOP   This is a listing of the top ten players.  SFWSBTRV.EXE
  42.                    will create this file if it is not found. 
  43.    
  44.    The Sysop will then need to use a text editor to edit the SF.BAT file   
  45.    as illustrated below:
  46.    
  47.    :DOOR_A
  48.    COPY SFDOORS.DAT C:\SF\DOOR_A
  49.    CD\SF\DOOR_A
  50.    SFWSBTRV
  51.    ERASE SFDOORS.DAT
  52.    CD\SF
  53.    GOTO LOOP
  54.  
  55.    You will notice that the commands needed to execute SFWSBTRV are placed
  56.    between the :DOOR_A and GOTO LOOP command lines.  These are entered in
  57.    place of the existing REM Place Program Name Here.  The following will 
  58.    briefly explain each of the commands which were set up within SF.BAT to 
  59.    run SFWSBTRV as a  SPITFIRE door program:
  60.    
  61.       SFDOORS.DAT is created automatically by SPITFIRE when a user enters a
  62.    door.  It contains information about the user such as name and password.
  63.    SFWSBTRV reguires access to the information within SFDOORS.DAT, Therefore,
  64.    before executing the program it must be copied to the directory in which
  65.    SFWSBTRV is running.
  66.    
  67.      SFWSBTRV is the program name and executes the game program from within
  68.    the door program.
  69.    
  70.       Once the user has terminated the game play of SFWSBTRV the SF.BAT file
  71.    erases the SFDOORS.DAT file.
  72.  
  73.  
  74.    SFWSBTRV SETUP AS A SYSOP CONFIGUREABLE COMMAND
  75.    --------------------------------------------- 
  76.  
  77.       SPITFIRE has a sysop configurable command for the Main, Message and
  78.    File menus.  The sysop configurable command is executed through a
  79.    batch file which corresponds to the menu it is being run from.  In
  80.    other words, SFMAIN.BAT runs the sysop configurable command from
  81.    the Main Menu, SFMESS.BAT runs the one from the Message Menu and
  82.    SFFILE.BAT the one from the File Menu.  The commands necessary
  83.    to execute SFWSBTRV can be setup in the batch file which corresponds
  84.    to the menu you wish to have SFWSBTRV run from.
  85.  
  86.       The first thing you will need to establish is which of these menus
  87.    you wish to use to run SFWSBTRV  For this purpose, let's assume that
  88.    it is going to be set up so it can be run from the Main Menu.  (It
  89.    should be noted the set up procedure is the same regardless of which
  90.    Menu you are running SFWSBTRV from.)
  91.  
  92.       Next, you will need to decide what you wish to name the command
  93.    option and establish what security level will be required for
  94.    users of your system to be able to access this option.  Once this
  95.    is determined you will need to modify the SFMAIN.MNU file using
  96.    your favorite text editor, as long as it saves in ASCII format.
  97.    (Refer to the SPITFIRE manual for further documentation on this
  98.    if needed.  It should also be noted that if SFWSBTRV were being
  99.    set up to run from the File Menu, you would need to modify the
  100.    SFFILE.MNU file and if it was being set up to be run from the
  101.    Message Menu you would need to modify the SFMSG.MNU file.)
  102.  
  103.  
  104.       Examining the default SFMAIN.MNU file, you will notice the sysop
  105.    configurable command appears as:
  106.  
  107.         <K>............. Add Your Own,,1000,@
  108.  
  109.  
  110.       This will need to be replaced with a Command Character that will
  111.    be used to select the option from the menu.  It is ASOLUTELY IMPERATIVE
  112.    that the Command Character must not duplicate an existing Command
  113.    Character for another menu option.  You will then need to include
  114.    a brief description of the Wildcat door program you are running, two
  115.    commas, the security level required to access this feature, and another
  116.    comma followed by the a @.  The @ must not be changed! (For more detailed
  117.    information on modifying your SFMAIN.MNU, SFMSG.MNU or SFFILE.MNU refer
  118.    to your SPITFIRE manual.)
  119.     
  120.        <K>.... Brief Program Description,,10,@
  121.  
  122.  
  123.       Now you will need to modify the corresponding batch file, SFMAIN.BAT,
  124.    so that it can be executed from the Main Menu.  Do this using your
  125.    favorite text editor, as long as it saves in ASCII format.  (Again, it
  126.    should be noted that if SFWSBTRV were being setup to run from the File
  127.    Menu, you would need to modify the SFFILE.BAT file and if it was being
  128.    set up to be run from the Message Menu you would need to modify the
  129.    SFMESS.BAT file.)
  130.  
  131.      Place the SFWSBTRV.EXE file in the directory you wish to run the
  132.    program from. SFWSBTRV will create its own player score file,
  133.    SFWSBTRV.TOP if does not already exist.
  134.  
  135.       The commands set up in the SFMAIN.BAT file are very similar to
  136.    those used for executing the game through a door in the SF.BAT file.
  137.    For instance, if you were running SFWSBTRV from the main SPITFIRE
  138.    directory your SFMAIN.BAT file might look like this:
  139.  
  140.        ECHO OFF
  141.        BRK OFF
  142.        SFWSBTRV
  143.        BRK ON
  144.  
  145.       (BRK is not included in the SPITFIRE package because it is written
  146.    and copyrighted by Solid Systems, 1985, but can be downloaded from
  147.    The Mother Board BBS and Buffalo Creek's BBS as well as a number of 
  148.    other BBS systems.  BRK is not required to run SFWSBTRV, however it
  149.    is recommended since it will prevent a user using the CTRL BRK command 
  150.    to terminate the batch file, gaining access to your system at the 
  151.    DOS level.)
  152.  
  153.       If you wish to set SFWSBTRV up in a seperate subdirectory from
  154.    SPITFIRE, for instance, a subdirectory named SFWSBTRV, your batch
  155.    file might look like this.
  156.  
  157.        ECHO OFF
  158.        BRK OFF
  159.        COPY SFMAIN.DAT \SF\SFWSBTRV
  160.        CD \SF\SFWSBTRV
  161.        SFWSBTRV
  162.        ERASE SFMAIN.DAT
  163.        CD \SF
  164.        BRK ON
  165.  
  166.  
  167.       When SFWSBTRV is executed from either the door with the SF.BAT file
  168.    or from the sysop configurable command through a menu with the
  169.    corresponding batch file, it will first look for the SFMAIN.DAT file,
  170.    then the SFMESS.DAT file, then the SFFILE.DAT file and lastly the
  171.    SFDOORS.DAT file.  It will look for each of these files until it finds
  172.    it and the commands required for its execution.  If none of these
  173.    files are found, SFWSBTRV will halt its execution
  174.    
  175.  
  176.    LOCAL PLAY OF SFWSBTRV
  177.    ---------------------
  178.  
  179.       It should also be noted that a Sysop can play SFWSBTRV locally by
  180.    entering the following command at the DOS prompt:
  181.    
  182.    C:> SFWSBTRV /L
  183.  
  184.  
  185.    DTE LOCK FEATURE
  186.    ----------------
  187.  
  188.      SFWSBTRV automatically detects if the DTE is locked at 19200 baud.  If
  189.    SFWSBTRV detects that the DTE is locked, then SFWSBTRV opens the serial
  190.    port to the maximum baud rate of your system.  If SFWSBTRV does not
  191.    detect that the DTE is locked, then the serial port is opened to the
  192.    baud rate of the caller.
  193.  
  194.      
  195.    SFWSBTRV EXECUTION
  196.    ------------------
  197.       
  198.    When first executed, SFWSBTRV will display a list of the Top Ten high
  199.    score players and the percentage of correct responses they acheived
  200.    while playing SFWSBTRV  Initially, this will be a dummy listing with
  201.    ten lines that display:
  202.    
  203.       0%...............YOUR NAME COULD BE HERE
  204.       
  205.    However, as the game is played, this will fill with the name of the
  206.    players and their percentage ratings.  
  207.    
  208.    NOTE: At least twenty questions must be attempted before SFWSBTRV will
  209.    figure the percentage rating for the player.
  210.          
  211.    To keep things interesting...the Sysop can erase the file which contains
  212.    the top ten listings SFWSBTRV.TOP on a routine basis to give additional
  213.    players a chance to have their name added to the list.
  214.    
  215.    As the top ten list is displayed, at the bottom of the screen  is a
  216.    question which prompts the user whether they want to have ANSI Graphics
  217.    (y/n)? available to them during game play.  If the user responds with a
  218.    y (for yes) the game will display in color and if the user responds with
  219.    a n (for no) the game will display in monochrome.
  220.    
  221.    ------------------------------------------------------------------------
  222.    
  223.       
  224.         SFWSBTRV.ZIP is distributed as FREEWARE software. You are free to
  225.    use, copy,or share with no restrictions!
  226.    
  227.                              Have Fun & Enjoy
  228.                              Walt Bush
  229.                              The Rossmoyne Mall
  230.                              Located in Cincinnati, Ohio
  231.                              Home of 1990 World Champion Reds
  232.  
  233.    ----------
  234.    DISCLAIMER
  235.      Walt Bush shall not be held responsible for any damage incurred
  236.    by the user to hardware, software, or peripheral devices while running
  237.    SFWSBTRV. All responsibility belongs to the user of the software.
  238.    
  239.    
  240.       Many thanks are indeed owed to Mike Woltz of Buffalo Creek BBS (515)-
  241.    225-8496 for his assistance.  Without his help this program would not
  242.    have been possible.   
  243.  
  244.  
  245.    SFIRETRV and other SPITFIRE programs are available for download from:
  246.    
  247.         Buffalo Creek BBS                     The Mother Board BBS
  248.         Sysop - Mike Woltz                   Sysop - Jacque Shipley
  249.           (515) 225-8496                         (515) 986-3445
  250.        19200/9600/2400/1200                      9800/2400/1200
  251.  
  252.                              The Rossmoyne Mall
  253.                              Sysop - Walt Bush
  254.                              (513) 793-9257
  255.                            19200/9600/2400/1200
  256.                                  676 Megs
  257.  
  258.